home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / dev / misc / FlexCat.lha / FlexCat.readme < prev    next >
Encoding:
Text File  |  1999-11-28  |  5.2 KB  |  124 lines
  1. Short:    2.4 - Flexible catalogs (C, Asm, Oberon, E, ARexx, Modula...)
  2. Author:   Marcin Orlowski <carlos@amiga.com.pl>
  3. Uploader: Marcin Orlowski <carlos@amiga.com.pl>
  4. Type:     dev/misc
  5. Version:  2.4
  6. WWW:      http://amiga.com.pl/flexcat/
  7. Date:     Sun Nov 28 04:21:13 1999
  8.  
  9.  
  10.  
  11.   INFO
  12.   ----------
  13.  
  14.     FlexCat creates catalogs and the source to handle them.  The difference
  15.   between FlexCat and KitCat, CatComp and some others is, that FlexCat is
  16.   designed to produce any source you want:  any programming language, any
  17.   individual needs should be satisfied.  However, FlexCat is not more
  18.   difficult to use.
  19.  
  20.     Translators will also find it useful, as, among standard functions
  21.   like #?.catalog creation, FlexCat is able to update your #?.ct files
  22.   to the new #?.cd files automatically. Give it a try! 
  23.  
  24.     This sounds like a contradiction.  FlexCat's solution is to use
  25.   template files, the so called "source descriptions".  Ready to use examples
  26.   for Assembler, C, C++, E, Oberon and Modula-2 are distributed, additionally
  27.   an example for supporting catalogs on Workbench 2.0.  Any other examples
  28.   are welcome.
  29.  
  30.  
  31.   Archives
  32.   ----------
  33.  
  34.     Since release 2.0, the FlexCat distribiution is splitted into the
  35.   smaller archives. They are (in order of importance):
  36.  
  37.   FlexCat.lha           - Latest FlexCat, user contribitions, english manual
  38.                          and foreign catalog files
  39.  
  40.   FlexCat_0x0.lha       - patches for 020, 040 and 060 versions of FlexCat
  41.                          (PPC makes no sense here. I checked that).
  42.  
  43.   FlexCat_ExDocs.lha    - FlexCat's guide in non english languages. Currently
  44.                          Svenska, Espanol and Deutsch are provided
  45.  
  46.   FlexCat_CatSrc.lha    - #?.cd and #?.ct files for existing translations and
  47.                          #?.texinfo documents
  48.  
  49.   FlexCat_Src.lha       - C source code for the FlexCat itself
  50.  
  51.   FlexCat_Demos.lha     - example source codes -> shows how to make localized
  52.                           programs using FlexCat (C/HSPascal/ARexx/etc)
  53.  
  54.                           NOTE: I would gladly welcome examples for other
  55.                           languages (E/Asm etc) as well as detailed tutorials 
  56.                           about right way of doing localized software.
  57.                           Your contribution is highly welcome!
  58.  
  59.  
  60.   If you just want to use FlexCat, the 1st archive is all you need.
  61.   If you want to have CPU optimised binaries, take both 1st and 2nd
  62.   and patch the original release.  If you want to read translated manual,
  63.   get the 3rd one.  If you want to make the translation take the 4th one
  64.   (but I suggesto to join the Amiga Translators' Organisation
  65.   <http://ato.vapor.com/ato> first!)
  66.  
  67.  
  68.   Changes since previous release:
  69.   -------------------------------
  70.   * v2.4 (28.11.99) - FlexCat is now portable! Thanks to Hardcode.sd{tm}
  71.                       unique technology you can now try to compile FlexCat
  72.                       under any OS (both Big and Little Endians are
  73.                       supported). Read developer.readme for details.
  74.  
  75.                     - sometimes garbage could be written instead of
  76.                       $VER: string (when $TODAY feature was used) due
  77.                       to memory block being free'd before write.
  78.  
  79.                     - added ##rem command to .sd file handling. As you
  80.                       have probably guessed, it's just remark. The goal
  81.                       (at least for me) is that ##rem lines won't appear
  82.                       in result source code, creaded out of the .sd file.
  83.  
  84.                     - added manual catalog open/close for compilers that
  85.                       do not handle autoinit/exit functions
  86.  
  87.                     - Updated french translation (Herve Dupont
  88.                       <herve.dupont@nordnet.fr>)
  89.  
  90.                     - Added NOSPACE switch, to avoid extra space char
  91.                       usually used by FlexCat to separate comment
  92.                       mark ';' from the main comment text
  93.  
  94.                     - Source descriptor for HSPascal by Artur Karpunin
  95.                       <woody8@kki.net.pl> is now available.
  96.  
  97.                     - New archive "FlexCat_Demos" full ;-) of example
  98.                       source codes for various programming languages
  99.                       C, HSPascal and ARexx examples are recently
  100.                       available.
  101.  
  102.                     - Content of "Contribution" drawer is now moved to
  103.                       "FlexCat_Demos" archive.
  104.  
  105.                     - Added detailed tutoral (in polish for now) about
  106.                       the whole localization process (incl. examples)
  107.  
  108.  
  109.   * v2.3 (19.05.99) - "Trailing ellipsis" detector was broken (Marco
  110.                       De Vitis <marco.dvv@flashnet.it>)
  111.  
  112.                     - Seems I updated the english manual for v2.2, but
  113.                       forgot to create .guide file out of texinfo.
  114.  
  115.                     - Fixed manual to say "1999" instead of "1998", and
  116.                       fixed #?.cd file to show proper arguments when
  117.                       help ("?") is requested (Herve Dupont
  118.                       <herve.dupont@nordnet.fr>)
  119.  
  120.                     - Spanish translation by Sergio Martín Rodríguez
  121.                       <smartin@kaos.es> and Tomás J. Cantó
  122.                       <tjcanto@redestb.es>
  123.  
  124.